Styles 用于设置对象的外观。 lvgl 中的样式很大程度上受到 CSS 的启发。 简而言之，其概念如下：

样式是一个 lv_style_t 变量，它可以保存边框宽度、文本颜色等属性。 它类似于 CSS 中的“类”。

可以将样式分配给对象以更改其外观。 在赋值时，可以指定目标部分（CSS 中的pseudo-element）和目标状态（pseudo class）。例如，当滑块处于按下状态时，可以将“style_blue”样式添加到滑块的旋钮。

任何数量的对象都可以使用相同的样式。

样式可以级联，这意味着可以将多个样式分配给同一个对象，并且每个样式可以具有不同的属性。 因此，并非所有属性都必须在样式中指定。 LVGL 将搜索一个属性，直到一个样式定义它，或者如果它没有被任何样式指定，则使用默认值。 例如，style_btn 可以导致默认的灰色按钮，而style_btn_red 只能添加一个background-color=red 来覆盖背景颜色。

最近添加的样式具有更高的优先级。 这意味着如果一个属性以两种样式指定，则将使用对象中的最新样式。

如果未在对象中指定，某些属性（例如文本颜色）可以从父级继承。

对象也可以有比“正常”样式更高优先级的本地样式。

与 CSS（伪类描述不同的状态，例如:focus）不同，在 LVGL 中，一个属性被分配给给定的状态。

当对象改变状态时可以使用转换或者变换。

对象可以处于以下状态的组合：

LV_STATE_DEFAULT 正常、释放状态

LV_STATE_CHECKED 切换或选中状态

LV_STATE_FOCUSED 被键盘、编码器或触摸板/鼠标选中

LV_STATE_FOCUS_KEY 通过键盘或编码器选中，但不通过触摸板/鼠标选中

LV_STATE_EDITED 由编码器编辑

LV_STATE_HOVERED 鼠标悬停（暂不支持）

LV_STATE_PRESSED 点击中

LV_STATE_SCROLLED 滚动中

LV_STATE_DISABLED 去使能状态

LV_STATE_USER_1 用户定义

LV_STATE_USER_2 用户定义

LV_STATE_USER_3 用户定义

LV_STATE_USER_4 用户定义

一个对象可以同时处于聚焦和按下等状态的组合。 这表示为 LV_STATE_FOCUSED | LV_STATE_PRESSED.

可以将样式添加到任何状态或状态组合。 例如，为默认状态和按下状态设置不同的背景颜色。 如果属性未在状态中定义，则将使用最佳匹配状态的属性。 通常这意味着使用属性LV_STATE_DEFAULT。˛ 如果即使为默认状态也未设置该属性，则将使用默认值。 （见后）

但最佳匹配属性到底意味着什么？ 状态有一个由其值显示的优先级（请参见上面的列表）。值越大，优先级越高。 为了确定要使用哪个状态的属性，让我们举一个例子。假设背景色的定义如下：

LV_STATE_DEFAULT: white

LV_STATE_PRESSED: gray

LV_STATE_FOCUSED: red

最初，对象处于默认状态，因此情况很简单：属性在对象的当前状态中完全定义为白色。

按下对象时，有两个相关属性：默认为白色（默认为与每个状态相关）和按下为灰色。按下状态具有0x0020优先级，高于默认状态的0x0000优先级，因此将使用灰色。

当对象被聚焦时，与按下状态下发生的情况相同，将使用红色。（选中状态的优先级高于默认状态）。

当对象聚焦并按下时，灰色和红色都可以工作，但按下状态的优先级高于聚焦状态，因此将使用灰色。

但也可以为设置为玫瑰色 LV_STATE_PRESSED | LV_STATE_FOCUSED. 在这种情况下，此组合状态的优先级为0x0020+0x0002=0x0022，高于按下状态的优先级，因此将使用玫瑰色（红加灰）。

当对象处于选中状态时，没有属性可设置此状态的背景色。因此，由于没有更好的选项，对象在默认状态的属性中保持为白色。

一些实用说明：

状态的优先级（值）非常直观，这是用户期望的。例如，如果一个对象被聚焦，用户仍然希望看到它是否被按下，因此按下状态具有更高的优先级。如果聚焦状态具有更高的优先级，它将覆盖按下的颜色。

如果要为所有状态设置属性（例如，红色背景色），只需将其设置为默认状态。如果对象找不到其当前状态的属性，它将返回默认状态的属性。

使用OR运算符描述复杂情况的属性。（例如，按下+选中+聚焦）

为不同的状态使用不同的样式元素是个好习惯。例如，想要找到按下、选中+按下、聚焦、聚焦+按下、聚焦+按下、聚焦+按下+选中等状态时的背景色相当困难。相反，例如，对按下和选中的状态使用背景色，并用不同的边框颜色指示聚焦状态可能会更好。

不需要在一种样式中设置所有属性。可以向对象添加更多样式，并使后来添加的样式修改或扩展外观。 例如，创建常规灰色按钮样式，并为仅设置了新背景色的红色按钮创建新样式。

这与CSS中列出的类非常相似 .

以后添加的样式优先于以前设置的样式。因此，在上面的灰色/红色按钮示例中，应首先添加普通按钮样式，然后添加红色样式。 但是，仍然需要考虑到状态的优先级，比如：

基本按钮样式为默认状态定义深灰色，为按下状态定义浅灰色

红色按钮样式在默认状态下将背景颜色定义为红色

在这种情况下，当按钮被释放（处于默认状态）时，它将是红色的，因为在最近添加的样式（红色）中找到了完美匹配。 当按钮被按下时，浅灰色是更好的匹配，因为它完美地描述了当前状态，所以按钮将是浅灰色。

某些属性（通常与文本相关的属性）可以从父对象的样式继承。 仅当未在对象的样式中设置给定属性时（即使在默认状态下），才应用继承。

在这种情况下，如果该属性是可继承的，则将在父对象中搜索该属性的值，直到某个对象为该属性指定了一个值。 父对象将使用自己的状态来确定值。因此，如果按下按钮，并且文本颜色来自此处，则将使用按下的文本颜色。

对象由部件块组成，每个部件块都有自己的样式。

LVGL中存在以下预定义的部件块：

LV_PART_MAIN 像矩形的背景

LV_PART_SCROLLBAR 滚动条

LV_PART_INDICATOR 指示器，例如用于滑块、条、开关或复选框的勾选框

LV_PART_KNOB 旋钮

LV_PART_SELECTED 指示当前选择的选项或部分

LV_PART_ITEMS 多个相似元素 (如图表中的单元格)

LV_PART_TICKS 刻度，例如在仪表上

LV_PART_CURSOR 光标，标记特定区域

LV_PART_CUSTOM_FIRST 自定义

如一个滑块 Slider 有以下几个部件块:

背景

指示器

旋钮

这意味着滑块的三个部分都可以有自己的样式，请参见下文如何向对象和部件块添加样式。

样式存储在 lv_style_t 变量中。样式变量应为静态static、全局global或动态分配dynamically allocated。

换句话说，它们不能是函数中的局部变量，因为函数退出时局部变量会被销毁。

在使用样式之前，应使用lv_style_init(&my_style)对其进行初始化。初始化样式后，可以添加或更改特性。

使用函数 lv_style_set_(&style, ); 来设置样式，例如：

如果想要删除属性可以使用如下的方式：

如果想要读取属性可以使用如下的方式：

lv_style_value_t 有3个字段:

num 是整数、布尔值和不透明度属性

color 是颜色属性

ptr 是指针属性

要重置样式（清除其所有数据），请使用：

样式也可以构建为const以保存在RAM中：

const定义的样式可以像其他样式一样使用，但（显然）不能添加新属性。

如果仅仅是定义一种样式并没有什么用，我们需要把样式指定给部件（widget）才能发挥它的效果。

使用函数 lv_obj_add_style(obj, &style, )向一个对象（object）添加样式. 是一个可以通过或运算定义的参数，它代表向某个部件块的某个状态添加样式，例如：

LV_PART_MAIN | LV_STATE_DEFAULT

LV_STATE_PRESSED: 代表主部件被按下时 LV_PART_MAIN 可以省略

LV_PART_SCROLLBAR: 代表默认状态时的滚动条

LV_STATE_DEFAULT 可以省略

LV_PART_SCROLLBAR | LV_STATE_SCROLLED: 代表对象滚动时的滚动条部分

0 和 LV_PART_MAIN | LV_STATE_DEFAULT 的含义一样

LV_PART_INDICATOR | LV_STATE_PRESSED | LV_STATE_CHECKED 代表指示器被按下并被选中时

使用样式 lv_obj_add_style:

使用函数 lv_obj_remove_style_all(obj) 来删除对象的所有样式。

使用函数 lv_obj_remove_style(obj, style, selector) 来删除指定部件块、状态的样式。 此函数只会在匹配上在执行函数 lv_obj_add_style 时设置的 selector 参数之后才执行删除操作。

参数style 可以为 NULL 来达到删除 selector 里的所有样式

参数 selector 可以使用 LV_STATE_ANY 和 LV_PART_ANY 两个值来删除任何状态或者任何部件块的样式

如果已分配给对象的样式发生更改（即添加或更改属性），则应通知使用该样式的对象。 有 3 个选项可以执行此操作：

如果更改的属性可以通过简单的重绘（例如更改颜色或不透明度）来更新，只需调用函数 lv_obj_invalidate(obj) 或 lv_obj_invalidate(lv_scr_act())。

如果更改或添加了更复杂的样式属性, 并且知道哪些对象调用了该样式，则调用函数 lv_obj_refresh_style(obj, part, property)。要刷新所有部件块和属性，请使用 lv_obj_refresh_style(obj, LV_PART_ANY, LV_STYLE_PROP_ANY)。

如果想要检查某个对象的样式是否被更改并同时刷新它们，可以调用函数lv_obj_report_style_change(&style)来实现。 如果 style 为 NULL 则所有对象都会收到样式被更改的报告

由于对象的样式存在级联、继承、局部样式和变换，某些时候我们可以需要获得属性的最终值，可以通过函数 lv_obj_get_style_(obj, ) 来实现。

函数会读取对象的当前状态，如果当前状态的属性值未被更改，则返回默认值。

例如：

除了 普通 样式之外，对象还可以存储局部样式。 这个概念类似于 CSS 中做了修改的内联样式 (e.g. ) .

局部样式与普通样式类似，但它们不能在其他对象之间共享。 如果使用，局部样式会自动分配，并在删除对象时释放。在向对象添加局部定义时很有用。

与 CSS 不同，LVGL 局部样式可以分配给状态 (pseudo-classes) 和部分 (pseudo-elements)。

使用函数 lv_obj_set_style_(obj, , ); 来分配局部样式

例如:

请看 here.

在部件块的文档中，您将看到“部件块使用典型的背景属性”这样的句子。这些“典型背景属性”与以下相关：

背景 Background

边界 Border

轮廓 Outline

影子 Shadow

填充 Padding

宽度和高度变换 Width and height transformation

X和Y变换 X and Y translation

默认情况下，当对象更改状态时（例如按下），对象将立即更新到新状态所对应的属性。如果使用变换的方式，我们可以实现状态更改的动画效果。

例如，按下按钮时，其背景颜色可以在300毫秒内变化为按下状态颜色。

变换的参数同样存储在样式里并且可以设置：

变换时间 the time of the transition

延迟变换时间 the delay before starting the transition

动画路径（也称为计时或缓动功能） the animation path (also known as the timing or easing function)

动画的属性 the properties to animate

可以为每个状态定义变换属性，例如，给默认状态设置500ms的变换过程，当对象变为默认状态时就会使用500ms变换这个参数，同时，给按下状态设置 100 ms 的转换时间，则进入按下状态时，经历100ms的变换过程。

此这个例子的效果就是按钮快速进入按下状态，然后缓慢返回默认状态。

如果我们需要变换这一功能的话，则需要初始化变量 lv_transition_dsc_t 。

TODO

主题是样式的集合，如果启用主题，LVGL会将其应用到每个部件（widgets），这将为 UI 提供默认的外观，然后可以通过添加更多样式进行修改。

每个显示器都可以有不同的主题。 例如，您可以在 TFT 上使用彩色主题，在单色显示器上使用单色主题。

要使用主题，需要进行两个设置：

初始化主题 Initialize a theme

将主题应用到对应的显示器 Assign the initialized theme to a display.

主题初始化函数可以有不同的原型。 此示例显示如何设置“默认”主题：

LVGL内置了主题并存放在 lv_conf.h 中，通过定义 LV_USE_THEME_DEFAULT 1 来使能默认主题。

内置主题可以扩展，如果用户创建了自己的主题，LVGL将会把自定主题作为默认主题的子主题，可以设置任意数量的包含主题，如 default theme -> custom theme -> dark theme.

使用函数 lv_theme_set_parent(new_theme, base_theme) 来扩展主题，其中 base_theme 是父主题， new_theme 是子主题。

示例如下

警告

doxygenfile: Unable to find project ‘lvgl’ in breathe_projects dictionary

警告

doxygenfile: Unable to find project ‘lvgl’ in breathe_projects dictionary

警告

doxygenfile: Unable to find project ‘lvgl’ in breathe_projects dictionary

警告

doxygenfile: Unable to find project ‘lvgl’ in breathe_projects dictionary